fix(text): KoPub 한자·전각 기호를 한글이 아닌 글꼴 자신의 전진폭으로 잰다 (#8099) - #8111

Closes #8099

무엇을 고쳤나

KoPub돋움체·바탕체의 한자·전각 기호를 rhwp 가 한글 전진폭(돋움 0.872 · 바탕 0.94)으로 쟀고, 「」『』·× 등은 KoPub 표 밖이라 공통 폴백으로 갔다. 글꼴과 한/글 Print 는 이 글자들을 한글과 다른 900/1000em(낫표 450)으로 전진시킨다. 한자·기호가 많은 줄에서 바탕은 넓게, 돋움은 좁게 잡혀 줄 안 배치가 한컴과 갈렸다.

근거

① 글꼴 cmap+hmtx 직독 — KOPUS 배포 KoPub·KoPubWorld 바탕·돋움 × Light·Medium·Bold 12개 프로그램:

한글 가–힣                         바탕 936 · 돋움 872
한자 4E00–9FFF · F900–FAFF         900   (굵기 사이 차이는 한자 몇 자 ±2)
○□◆ ①② →⇒ ☆ ✓ ㉠ ㎜ Ⅰ ※ ×±       900
전각 ！–～ · ￠–￦ · 옛 자모 ㅤ–ㆎ(ㆍ)  900
、。〈〉《》「」『』【】〔〕          450
◦ 600 · ₩ 894 · £ 533/555 · ¥ 520/706 (돋움/바탕)

② 한/글 Print — 정본 pdf/2025 행정업무운영 편람(최종)-2020-kopub.pdf(Hwp 2020 11.0.0.9136, KoPub 서브셋 내장, 383쪽)의 글자 전진(원점 차이)을 같은 줄 한글 전진으로 나눈 비가 글꼴 비와 맞는다.

× 도 PDF 57쪽(문서 49쪽) (×) 에서 ○·→ 와 같은 0.804em(장평·자간 포함)으로 놓인다.

변경

• text_measurement.rs kopub_cjk_symbol_units: KoPub·KoPubWorld 공통 갈래 — 한자 · 옛 자모 · 전각 FF01–FF5E·FFE0–FFE6 · CJK 기호(450 / 　〃〓 900) · is_fullwidth_symbol 900 · ◦·₩·£·¥ 개별값. ※ 는 이 갈래로 옮겼다(값 0.9 그대로).
• text_measurement/kopub_symbol_advances.rs(생성 표): KoPub돋움체·바탕체의 U+0080–U+2FFF 전진폭 668자(세 굵기 동일). × ± ¶·그리스·키릴·수학 기호 등이 글꼴 값으로 잡힌다. 다른 규칙이 소유하는 글자(좁은 구두점 ··‧, 곡선 따옴표, 공백류, U+00A0·U+00AD)는 넣지 않았다.
• KoPubWorld 는 이 범위의 라틴·기호가 비례폭이고 일부는 굵기별로 달라(돋움 × 559 등) 공통 갈래만 쓴다.
• 상자 그리기(U+2500–257F)는 표에서 뺐다. rhwp 에서 이 블록은 주로 한컴 PUA 글머리표·선 문자의 표시 대체(map_pua_bullet_char: U+F080F → ━ 등)로 생기고, 한/글은 그 PUA 글리프를 KoPub 이 아닌 기호 글꼴로 그린다(편람 PDF 140쪽 글머리표: Haansoft Batang 0.46em). 정본 383쪽 전체에서 KoPub 으로 그려진 상자 그리기 글자는 0건이다. 이 블록을 표에 넣었을 때 PDF 139·140·297쪽(글머리표 ━ 줄)이 1~3%p 떨어지는 것을 확인하고 뺐다.
• 비범위: 현대 한글 호환 자모(ㄱ–ㅣ, 한글 전진폭과 같음)·가나(KoPubWorld 바탕만 1024 로 달라 출력 미확인)는 종전 경로. 글머리표 PUA 글리프의 전진폭을 문단 글꼴로 재는 것은 별도 결함이다(이 PR 범위 밖).

검증 (code head fd28c3bd2, 증적 head 84bdfc4bb, base devel 5e2b9bfbf)

회귀 검사 tests/cases/issue_8099_kopub_cjk_symbol_advance.rs

편람 HWP 의 쪽(아래 쪽 번호는 모두 PDF 쪽)마다 KoPub 글자 전진을 같은 쪽·같은 글꼴·같은 크기 한글 전진의 중앙값으로 나눈 비(한자는 언어 슬롯이 달라 한글과 다른 run 이 된다)를 정본에서 같은 방법으로 잰 값과 ±0.015 로 대조한다. 절대 px 이 아니라 비라서 줄 위치와 무관하다.

시험을 둔 채 src 만 되돌리면 첫 사례(38쪽 바탕 한자)부터 1.0070 으로 FAIL, 수정 후 PASS.

전쪽 Native / fresh WASM 2px 실루엣 — 편람 383쪽(정본 383쪽)

• 변화(±0.05 초과): Native 상승 44쪽 · 하락 7쪽, fresh WASM 상승 41쪽 · 하락 6쪽. 하락은 모두 0.15%p 이하(PDF 36·38·74·98·106·140·170·272쪽).
• 미달 2쪽(111·242)은 devel 과 같은 값이라 이 PR 과 무관하다.
• 직접 판독: PDF 60쪽(문서 52쪽, 아래 그림) 서식 예시의 ○○○ 행이 devel 에서는 정본보다 넓게 밀려 겹쳤고 head 에서 정본과 겹친다(엄격 내용 픽셀 82.74 → 85.80). PDF 106쪽(−0.15)은 줄 끝 위치가 정본과 같고 남은 차이는 devel 과 같은 국소 차이다. PDF 57쪽 (×) 줄은 × 가 ○·→ 와 같은 폭으로 잡힌다.

측정: visual_sweep.py --silhouette-only --dpi 96 --compat 2022, Native(native-skia PNG 래스터)와 fresh WASM(scripts/wasm-pack-locked.sh 로 같은 소스에서 새로 빌드, rhwp_bg.wasm sha256 2fe597341ecb7c22…). RHWP_FONT_PATH 앞에 KOPUS 배포 KoPub돋움체·바탕체 TTF(Light·Medium·Bold) 폴더를 넣어 devel·head 를 모두 다시 돌렸다(이전 판은 그 폴더를 경로에 넣지 않았다). Native 는 검증 기계의 사용자 글꼴(fontconfig)로 이미 같은 KoPub 을 쓰고 있어 결과가 같았고, fresh WASM 은 평균이 0.01 낮아졌다. 위 그림은 이 재실행의 산출물이다(head 84bdfc4bb).

코퍼스·게이트

• samples/** 1,252문서 layout-anomaly A/B(devel 대비): 바뀐 문서 0.
• 정답지 쪽수 원장 547문서: 542 일치(devel 과 같음).
• Rust lint 묶음(fmt diff 0 · Clippy native/wasm/workspace · manifest) 통과. nextest 11,017 중 11,016 통과 — 실패 1건 issue_6520_svg_layer_contract::subset_font_bytes_are_deterministic_for_multiple_codepoints 는 검증 기계에 한컴돋움(HDOTUM.TTF)이 사용자 글꼴로 설치돼 있어 시험이 그 TTF 를 임베드하면서 font/opentype 확인에 실패한 환경 문제다(그 글꼴이 없는 CI·devel 에서는 통과, 이 PR 무관).

🤖 Generated with Claude Code

최신 devel rebase (2026-10-23, #8173 절차)

• 기준 upstream/devel def947c21, head ef97704cf (이전 84bdfc4bb). 위 이미지 URL 은 새 head 로 갱신했다(같은 파일).
• 충돌: devel 에 메인터너의 KoPub 기호 명시 메트릭(src/renderer/layout/kopub_symbol_metrics.rs, 한컴 2024 Print CIDFont /W, KoPub 돋움·바탕만)이 들어왔다. kopub_char_advance_em 은 그 표를 먼저, 없으면 이 PR 의 표(kopub_cjk_symbol_units, KoPubWorld 포함)를 본다. 두 표에 함께 있는 글자는 값이 하나도 다르지 않음을 확인했다. devel 표에만 있는 · ‘’“” ‧ 는 이 PR 이 다른 규칙 소유로 표에서 뺀 글자라 devel 값이 그대로 쓰인다.
• 검사 수정(ef97704cf): rebase 뒤 issue_8099_kopub_cjk_symbol_advance 가 288쪽 바탕 「」 비 0.4929(정본 0.4778, 허용 0.015)로 실패했다. 「」 전진폭은 rebase 전후 같고(6.7–6.9px) 한/글 PDF(6.72·6.88px)와 같으며, 분모인 쪽 한글 중앙값이 devel 의 다른 변경으로 14.1 → 14.0px 움직인 탓이다. 한/글은 이 쪽을 두 크기(한글 13.92·14.40px)로, rhwp 는 한 크기로 묶어 쪽 중앙값이 두 무리 경계에 걸려 있었다. 기준을 같은 줄·글꼴·크기의 한글 중앙값으로 바꾸고 정본 비도 같은 PDF 에서 같은 기준으로 다시 쟀다(57쪽 × 만 0.8889 → 0.9638, 글꼴 비 900/936 = 0.962). 새 head 일곱 사례 모두 허용치 안(288쪽 0.4786), devel(이 검사 파일만 얹음)은 38쪽 바탕 한자 1.0000 으로 실패.
• 로컬 검증: fmt · Clippy 3종 · workspace build · manifest --check · unit tier 통과, nextest 는 rebase 직후 11,477건 중 위 검사와 issue_6520_svg_layer_contract::subset_font_bytes_are_deterministic_for_multiple_codepoints(이 host 의 시스템 한컴 글꼴 탓, base 동일, 무관) 2건 외 통과. 검사 수정 뒤 all-targets Clippy 와 해당 검사 재실행 통과.
• Visual Sweep(편람 383쪽, 2px 실루엣 raw, --compat 2022, RHWP_FONT_PATH 앞에 KoPub돋움·바탕 TTF, 빌드 전 소스 touch·sha256 확인, base = devel def947c21 + 무관 커밋):

• 위 본문의 «devel 대비 상승 44쪽 · PDF 60쪽 82.74 → 85.80 · 111·242쪽 미달» 은 rebase 전 base 기준이다. 현재 devel 은 메인터너 표로 같은 글자들을 이미 바로잡아 60쪽 99.86, 90% 미만 0쪽이다. 이 PR 이 현재 devel 에 더하는 것은 그 표 밖의 U+0080–U+2FFF 글자(글꼴 hmtx 668자), KoPubWorld 계열의 한자·전각 기호, 회귀 검사다.